home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 February / macformat-034.iso / mac / Shareware City / Developers / simple-sockets-11-c / Simple Sockets 1.1 ƒ / Read Me First
Encoding:
Text File  |  1995-11-28  |  6.7 KB  |  142 lines  |  [ttro/ttxt]
  1. Simple Sockets, 1995 Michael D. Trent
  2. Internet: mtrent@msn.fullfeed.com
  3.  
  4.  
  5. Version 1.1 December 1995: Maintenance Release.
  6.      • Updated code and projects for Metrowerks CodeWarrior 7.
  7.      • Added #ifdefs to allow Simple Sockets to jive with older headers w/o
  8.         extra modification.
  9.      • More documentation changes.
  10.      • A nifty new version of the manual "HTML-ified" by Chris Hanson <chanson@mcs.com>.
  11.      • Renewed commitment to keep this library in the public domain. People even offered to
  12.         pay a shareware fee for this! (Mind you, after I told them I DID accept donations, they
  13.         never wrote back ;-) ).
  14.  
  15.  
  16. Version 1.0.1 June 1995: Maintenance Release.
  17.      • Updated code and projects for Metrowerks CodeWarrior 6.
  18.      • Minor modifications to select(), recvfrom(), and maybe others.
  19.      • Select() has been added to the manual.
  20.      • Some additions to this file, including my new e-mail address.
  21.      • Added MacTCP header files (for those without them), and added a
  22.        “fixed” dnr.c file.
  23.  
  24. Version 1.0 April 1995: Initial release.
  25.  
  26.  
  27. What is Simple Sockets?
  28. ~~~~~~~~~~~~~~~~~~~~~
  29. Simple Sockets is a small, relatively simple C code library for approximating BSD
  30. UNIX socket calls with MacTCP.  Simple Sockets doesn't provide 100% faithful BSD
  31. port, rather it is a quick and easy way to "get the job done".  This is a work in
  32. progress;  BSD support should improve in time.   I welcome suggestions and
  33. criticisms of the source code.
  34.  
  35. Simple Sockets requires a compiler that uses Apple's new Universal Headers.  This
  36. includes Metrowerks CodeWarrior and newer versions of THINK C/C++, and whatever
  37. became of Apple's MPW based "Mac on RISC Developer Kit".  All sample applications
  38. are "fat binaries" compiled with Metrowerks CodeWarrior.  Simple Sockets should
  39. still work with older compilers after a few simple source changes.  If someone
  40. would like to go to the trouble to #ifdef the code, I'd be grateful.
  41.  
  42. Please see the accompanying files for more information about Simple Sockets.
  43.  
  44.  
  45. Why am I releasing Simple Sockets?
  46. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47. Every so often on various usenet groups, people ask about a socket interface for the
  48. Macintosh. Back when I was asking for one, the only stuff available was for MPW.
  49. One library in particular was terrifyingly unstable.  I thought, "By golly, as a MacTCP
  50. programming and UNIX socket programming novice, I can do a better job than this!!"
  51. So I wrote this. But I have a better reason for making this software public.
  52.  
  53. I believe Simple Sockets is most valuable as a good MacTCP example. The source code 
  54. itself is nice and small, fairly well documented, and very readable. It illustrates basic 
  55. MacTCP programming in a simple, easy to understand way. After all, if someone wants
  56. to do MacTCP programming, the last thing they should ever want to do is use the UNIX
  57. socket interface! Yuk!
  58.  
  59.  
  60. But what about GUSI?
  61. ~~~~~~~~~~~~~~~~
  62. I have been asked why I bothered to "roll my own" rather than use the Grand
  63. Unified Socket Interface (GUSI).  Well, I have my reasons, and since the curious
  64. must know:  until lately, GUSI was an MPW thing, and I didn't want to take the
  65. time to shape it to my CodeWarrior environment;  I needed only TCP/IP and UDP/IP
  66. sockets, and it seemed easier to write them myself rather than trying to use GUSI
  67. (or scarier, less refined software);  I could turn in my code for a grade; gain a
  68. sense of personal accomplishment; further my name and reputation; get e-mail from
  69. well-wishers, critics, and fellow socket software authors; and the list goes on…
  70.  
  71. Honestly though, if you desire strict BSD compatibility, or you want to use your
  72. socket programming skills to perform AppleTalk and other Macintosh IPC
  73. instantiations, I suggest you give GUSI a good, long look.  
  74.  
  75.  
  76. Licensing agreement
  77. ~~~~~~~~~~~~~~~
  78. Simple Sockets is passing directly into the Public Domain, w/o passing GO or
  79. collecting $200, with only one restriction (if this is possible).  Simple Sockets
  80. must be distributed in it's original archive form, containing code, ReadMe files
  81. and other documentation, and sample applications.  (Honestly, this stipulation is
  82. really a request - being Public Domain and all.)
  83.  
  84.  
  85. Contacting Michael Trent
  86. ~~~~~~~~~~~~~~~~~~~
  87. Thus far, I've tried to be extremely helpful for those who have questions about 
  88. Simple Sockets. I'll try to keep helping everyone who needs help, but I've 
  89. become extremely busy as of late.  If you're having problems getting the software
  90. to work under Symantec compilers, I'll try to help; but please keep in mind I 
  91. haven't used Symantec compilers seriously since I got Metrowerks Codewarrior 
  92. DR 3 in 1994.
  93.  
  94. Any questions/comments/offers of assistance/offers for entrance into a Masters
  95. Program at a good university can be directed to:
  96.  
  97. Michael D. Trent
  98. 3302 Leopold Way #110
  99. Madison, WI 53713
  100.  
  101. work e-mail:  mtrent@epicsys.com
  102. pleasure e-mail:  mtrent@msn.fullfeed.com
  103.  
  104. E-mail is preferred;  I may not receive snail-mail for several weeks.  Please try
  105. my "pleasure" e-mail first — I do check it daily. 
  106.  
  107.  
  108. Legal Stuff
  109. ~~~~~~~~~
  110. Simple Sockets may be freely distributed by electronic means, provided that it is
  111. not modified in any way and that it is accompanied by all of the original
  112. documentation unaltered. 
  113.  
  114. Disclaimer of warranty:
  115. In using this software, you understand and agree that this software is provided
  116. “as is” without warranty of any kind.  The entire risk as to the results and
  117. performance of using this software lies entirely with you, the user.  The author
  118. does not make any warranties, either expressed or implied, including but not
  119. limited to implied warranties of merchantability and fitness for a particular
  120. purpose, with respect to this software.
  121.  
  122. In no event shall the author be liable for any consequential, incidental, or
  123. special damages whatsoever (including without limitation damages for loss of
  124. critical data, loss of profits, interruption of business, and the like) arising
  125. out of the use or inability to use this software.  Because some states do not
  126. allow the exclusion or limitation of liability for consequential or incidental
  127. damages, the above limitations may not apply to you.
  128.  
  129. Although the author would appreciate any feedback and bug reports, the author
  130. shall not be responsible for correcting any problems which you discover or
  131. otherwise help you maintain and use this software.  Furthermore, the author may
  132. at any time replace, modify, alter, improve, enhance or change this software.
  133.  
  134. Complete agreement:
  135. This agreement constitutes the entire agreement and supersedes any prior
  136. agreements between you and the author concerning this software.  This agreement
  137. cannot be amended, modified, or waived except in writing.
  138.  
  139. General:
  140. If any provision of this agreement shall be found to be unenforceable, it shall
  141. be deemed severed from the remainder of this agreement.
  142.